U.K. PET USERS CLUB 


NEWSLETTER NO. 0 

Welcome to the U.K. PET Users Club and in this issue, we have 
some hints on graphics animation, details of BASIC interpreter 
timings and memory usage, and of ASCII codes plus much more. 

Printed in this and all subsequent issues, there will be a list 
of software available through the Users Club. The original list 
is small and Commodore Systems generated, but we hope to add 
many programmes in the near future. We intend to form a 
"Common Library" which will contain programmes submitted by PET 
users and we hope you will contribute. The contents of 
both Libraries : will be printed in each issue. 

For each of your programmes accepted, you will be given the choice 
of up to three from the Common Library, free of charge or you may 
purchase any programme from the Common Library for £1.00 per pro¬ 
gramme plus 30 pence for p+p. We also hope that you will write 
to us telling us of your applications for and your experiences 
with the PET. We will endeavour to publish as many of your letters 
and comments as we can and if anyone feels like submitting a small 
article, this will be most welcome. If you require a personal 
reply this will be guaranteed by enclosing a self addressed, stamped 
envelope. 

The address to which you send your correspondence or orders is:- 

The Software Manager, 

Commodore Systems Division, 

360, Euston Road, 

London, N.W.l. 

N.B. Please note CHANGE OF OUR ADDRESS. 
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A SHORT NOTE ON MOVING THINGS 

Difficulty has been experienced by some of our users in moving 
the cursor under programme control and questions have been asked 
about how graphs and plots such as sine curves can be displayed. 

As you probably already know# cursor control characters in quotes 
when printed will cause the cursor to move accordingly. If your 
experiments so far with this technique are giving slightly odd 
results, do make sure that you are terminating your print state¬ 
ment with a semi-colon. Failure to do this will cause the machine 
to output a carriage return/line feed at the end of the print 
statement, leaving the cursor just where you don’t want it. 

On the subject of plotting, the basic trick used with this type 
of graphic system is to first create strings full of cursor 
movement characters and then access parts of them using MID$, etc. 
dynamically. 

For a really good example of the use of this technique, I suggest 
you have a look at the technique used in our biorhythm programme. 


BITS AND PIECES 


ARE YOP READY? 

There have been reported mysterious occurences of flic otit of 
data error when editing and fiddling about in general. 

This is not a bug, but is due to pressing RETURN whilst the 
cursor is over the READY prompt. The machine interprets this 
as READ Y and as there is usually no corresponding date state¬ 
ment around we get the error. 

REDO 

It must be remembered that when RETURN is pressed, the machine 
consumes everything on the same line as the cursor, so even if 
you have correct information at the beginning of a given line, 
a single character of an incorrect type far over on the right 
hand side of the screen on the same line is likely to cause 
problems. A rather problematical example of this situation 
occurs if you try and put up a graphic form or set of boxes 
on the screen and then under programme control ask for data . 
with an input statement, e.g. 

NUMBER ? 

When the number is typed and RETURN is pressed, the graphics 
character making up the right-hand side of the box will be 
entered as part of the inputting data. In the case of input 
to a numeric variable, the graphics character is of course 
non-numeric and not allowed and will give the error ? Redo 
from start, so you must always leave such boxes open ended. 
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INVERSE TRIGNOMETRIC FUNCTIONS 

Here are a couple of handy methods of obtaining are sine and arc 
cosine (remember, the result will be in radians). 

ASNX * ATN (X/SQR(1-Xf2) 

ACSX = ATN (SQR(1-Xf2)/X) 

For those of you who are used to working in degrees, here are some 
handy user defined functions: 

DEFFNS (V) = SIN (V/ (180/V) ) 

DEFFNC (V) - COStV/dSO/rf) ) 

DEFFNT (V) - TAN (V/( I 8 O/ 7 O ) 

These are three user defined functions which when called with 
arguments and degrees will give the appropriate results. In these 
examples V can be any variable but if all three are defined in 
the same programme, you must use three different dummy variables. 
EXAMPLE: PRINT FNS(30) 

Result of this will be .5. Notice that the argument for FNS, or 
FN anything for that matter, can be either a variable or numeric 
constant. Also, after a programme containing these definitions 
has been run, these functions may be called using FN in the direct 
mode, that is, from the keyboard directly without being in a 
programme. 
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SECOND CASSETTE UNIT 


The second cassette unit with lead and plug ready to go straight 
onto the second cassette port on the rear of the PET, will be 
available from the beginning of May at a cost £55.00 plus V.A.T. 
Some of the early units shipped, may have a small section of the 
body cut away at the back. This is because, these particular 
cassettes were meant originally to fit inside the PET. 

6502 PROGRAMMING MANUALS 

This really excellent MOS technology generated 22o page manual 
will be available at a cost of £5.00 plus 30pence p+p from the 
beginning of May. This manual, if read carefully from the begin¬ 
ning, is an excellent guide to microprocessor programming in. 

general, as well as being a first rate 6500 reference book. It 
is worth mentioning here, that for those of you who are interested 
in developing their knowledge and expertise in the field of 
microprocessing and cannot, at this point of time, afford a PET, 
then they might, perhaps, look at a KIM, a valuation board, which 
sells for £149 and contains a keyboard,display, 2K ROM plus IK RAMy 
cassette interface, 2 timers and much more. This valuation board 
is available in London through A.E. Marshalls Ltd or in the West 
Country from G.R. Electronics of Newport, Gwent. 

BASIC PROGRAMME STORAGE 


Below is a diagramatic representation of the method used by the 
CBM basic interpreter for storing programmes in memory. 
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EDITING 

There is an interesting property of the screen edit routine 
which gives rise to the following effectsi- 

If you insert using the INS key, more spaces than you type in 
characters/ the DEL key must be pressed twice the number of times 
there are spare spaces. E.g. If you insert six spaces in a 
middle of a line and only type in four new characters, the first 
two presses of the DEL key will produce inverse characters which 
will disappear on the next two presses. Remember, the INS key 
will move all characters including the one under the cursor 
to the right, whilst the DEL key will delete the character on its 
immediate left. 
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INTERRUPT STRUCTURE 

Interrupts (including Break or Software Interrupts) are handled 
by software polling. 

When the processor recognizes an interrupt it vectors through 
F FFE, FFFF in ROM to a routine that first inspects the processor 
hardware (IRQ line low). 

If it was caused by a Break instruction, a Jump Indirect is 
executed through locations 021B, C. If by a hardware interrupt then 
a Jump Indirect is taken through locations 0219, A. 

These locations being in RAM may be user-modified to point to 
extra user code ahead of normal interrupt processing. 

Note, however that the IRQ pointer is used by the cassette 

routines and should be restored to standard values before the cassette 

Save or Load functions are called. 

Various sections of the I/O chips can be set up to cause inter¬ 
rupts through the IRQ line. 

Example: POKE 59470,2 enables a negative edge on the 
user port CAL line to cause an interrupt. 

However, have your code set up to handle it when it happensI 

Also note that each pass through the regular interrupt code 
increments the time register. 




Interesting Locations Accessible from BASIC 


Location (decimal) Contents 


H L. 

225, 224 

226 

Byte address of screen line with Cursor 

Character position of Cursor (0 to 79) 

515 

Matrix-coordinate (row+column) of last key down 

255 if no key down 

516 

1 if shift down, 0 if shift up 

525 

526-534 

No. of characters in Keyboard Buffer 

Keyboard Buffer 

578 to 587 

588 to 597 

598 to 607 

610 

Logical numbers of open files 

Device numbers of open files 

Read/write modes of open files 

How many open files 

512, 513, 514 

518, 517 

59465, 59464 

Clock that increments 60 times a second 

Clock that increments 30 times a second? 

Clock that decrements every microsecond 

59456 

WAIT 59456,32,32 waits for vertical retrace of display 

64824 

SYS(64824) simulates power-on reset 

59469 

Interrupt Flag Register; e.g., to input user port CA1: 
l=PEEK(59469) AND 2: POKE 59469,1: IF 1=0 THEN CA1 low 

59411 

IEEE PIA B Control, e.g., to run cassette# 1 motor N jiffies: 

100 POKE 59411,53: T=TI 

200 IF TI-T<N GOTO 200 

300 POKE 59411,61 

ADVICE: Run motor at least 3 jiffies per 191 output chars 






















TIMING TABLES 

BASIC STATEMENTS AND 1/0 STRING FUNCTIONS (Cont'd) 

CONSTRUCT APPROX♦ TIME (MILLISEC) FUNCTION APPROX. TIME (MILLISEC) 
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Character ASC/CHR 

PEEK/POKE 

Character ASC/CHR 

i. 

PEEK/POKE 


0 


@ 

64 

0 


1 


A 

65 

1 


2 


B 

66 

2 


3 


C 

67 

3 


4 


D 

68 

4 


5 


E 

69 

5 


6 


F 

70 

6 


7 


G 

71 

7 


8 


H 

72 

8 


9 


I 

73 

9 


10 


J 

74 

10 


11 


K 

75 

11 


12 


L 

76 

12 

RETURN 

13 


M 

77 

13 


14 


N 

78 

14 


15 


0 

79 

15 


16 


P 

80 

16 

♦ 

17 


Q 

81 

17 

RVS 

18 


R 

82 

18 

HOME 

19 


S 

83 

19 

DEL 

20 


T 

84 

20 


21 


U 

85 

21 


22 


V 

86 

22 


23 


w 

87 

23 


24 


r 

88 

24 


25 


Y 

89 

25 


26 


. z 

90 

26 


27 


t 

91 

27 


28 


\ 

92 

28 


29 


] 

93 

29 


30 


t 

94 

30 


31 


-0 

95 

31 

space 

32 

vi 32 

space 

96 

32 

1 

• 

33 

33 

1 

97 

33 

tf 

34 

’ 34 

it 

98 

34 

# 

35 

35 

# 

99 

35 

$ 

36 

36 

$ 

100 

36 

X 

37 

37 

X 

101 

37 

& 

38 

38 

& 

102 

38 

# 

39 

39 

0 

103 

39 

< 

40 

40 

( 

104 

40 

) 

41 

41 

) 

105 

41 

* 

42 

42 

* 

106 

42 

■ + 

43 

43 

+ 

107 

43 

t 

44 

44 

* 

108 

44 

w 

45 

45 

- 

109 

45 

• 

46 

46 

• 

110 

46 

/ 

47 

47 

/ 

111 

47 

0 

48 

48 

0 

112 

48 

1 

49 

49 

1 

113 

49 

2 

50 

50 

2 

114 

50 

3 

51 

51 

3 

115 

51 

4 

52 

52 

4 

116 

52 

5 

53 

53 

5 

117 

53 

6 

54 

54 

6 

118 

54 

7 

55 

55 

7 

119 

55 

8 

56 

56 

8 

120 

56 

9 

57 

57 

9 

121 

57 

« 

58 

58 

• 

• 

122 

58 

• 

1 

59 

59 

• 

» 

123 

59 

< 

60 

60 

< 

124 

60 


61 

c a 

61 

m 

125 

1 R/ 

61 
£. R 


Character ASC/CHR PEEK/POKE 


RETURN 


It 

RVSoff 

CLEAR 

INST 







128 

129 

130 

131 

132 

133 

134 

135 

136 

137 

138 

139 

140 

141 

142 

143 

144 

145 

146 

147 

148 

149 

150 

151 

152 

153 

154 

155 

156 

157 

158 

159 

160 
161 
162 

163 

164 

165 

166 

167 

168 

169 

170 

171 

172 

173 

174 

175 

176 

177 

178 

179 

180 
181 
182 

183 

184 

185 

186 

187 

188 
189 


97 

98 

99 

100 
101 
102 

103 

104 

105 

106 

107 

108 

109 

110 
111 
112 

113 

114 

115 

116 

117 

118 

119 

120 
121 
122 

123 

124 

125 


Character ASC/CHR PEEK /POKE 



192 

64 

193 

65 

194 

66 

195 

67 

196 • 

68 

197 

69 

198 

70 

199 

71 

200 

72 

201 

73 

202 

74 

203 

75 

204 

76 

205 

77 

206 

78 

207 

79 

208 

80 

209 

81 

210 

82 

211 

83 

212 

84 

213 

85 

214 

86 

215 

87 

216 

88 

217 

89 

218 

90 

219 

91 

220 

92 

221 

93 

222 

94 

223 

95 

224 

96 

225 

97 

226 

98 

227 

99 

228 

100 

229 

101 

230 

102 

231 

103 

232 

104 

233 

105 

234 

106 

235 

107 

236 

108 

237 

109 

238 

110 

239 

111 

240 

112 

241 

113 

242 

114 

243 

115 

244 

116 

245 

117 

246 

118 

247 

119 

248 

120 

249 

121 

250 

122 

251 

123 

252 

124 

253 

RCA 

125 

1 


Price 

£ 8.00 

£ 6.00 

£ 8.00 

£ 3.00 

£ 8.66 

£ 5.00 

£ 8.00 

£15.00 

£ 3.00 


' Name 
Othello 

Pontoon 

Wrap Trap 

Noughts and 

Crosses 

1 

Lunar Lander 

Rotate 


h Biorhythms 


Disassembler 


Machine Code 
Hiihdler 


Description 

Cunning game of skill. Two levels 
of play, you against the computer. 

Board game. True 52 card pack 
plus amazing graphics. 

Dynamic graphics game in which the 
player has to trap the computer. 

Good arcade quality graphics. 

You against the computer. 

First class game of skill - in 
real time and with the odd surprise! 

Difficult if you are not an expert! 
Similar to little plastic trays with 
moveable letters and letter missing. 

Carefully written programme. Good 
graphics, with a real plot routine. 
Great fun for all the family. 

6500 series full disassembler asks 
for decimal starting location and 
lists from this point, gives full 
mnemonics and handles ASCII tables .a 

This programme allows you to type 
in a list of HEX codes from a given 
location. These routines can then 
be Called using the SYS verb. 



Please send 50p for p-+ p. 




Thebe* are many more programmes in preparation including math¬ 
ematics, statistics and even a line re-numbering routine. These 
and many more will be announced in our: next Newsletter. Aany 
people have asked about a series of good quality short casset¬ 
tes for the PET, so we have decided to make available C12 
cassettes, with blank labels and in individual boxes at a cost 
of 50 pence each. There is a minimum quantity order of 10 
cassettes, due to the small value of this item. Terms must be 
C.W.O. 

It is also worth mentioningthat Compendium Books of Camden Tovna. 
have an excellent Home Commuting section - carrying such things 
as Dr. Dobbs and Byte etc. Nearest tube is Camden Town also 
74B and 31 busess. 


SfOP PRESS 

R. Bailey Associates of 31 Bassett Road, London, ¥.16 are offering the following 
2 items for sale from the beginning of flay. 

Item'No. 1. : - 

I EEE to R S 232 ilash Serial Interface for £79.S0 + V*A*T* 

" item fito. 2. .■ ‘ r # 

Plug in flemory complete with Power Supply: 

8Kj- £225 + V.A.T. 

16K:- £400 + V.A.T. 


